home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / KEYBOARD / PLAY410.ARJ / PLAY.DOC < prev   
Text File  |  1991-04-19  |  11KB  |  261 lines
  1.              _ __    _    __   _    ,
  2.             ' )  ) _//   /  ) ' )  /    Sound Sample Editing
  3.              /--'  /    /--/   /  /     Software for the IBM
  4.             /     /___ /  (_  (__/_     PCs useless speaker!
  5.                                //
  6.              Version 4.10     (/        (C) Mark J Cox 1990/1
  7.  
  8. _____________________________________________________________________________
  9.  
  10.             New Version Documentation
  11.  
  12.                         See file WHAT-NEW.410
  13.  
  14. New Command: VOLUME.  Brings up a sub menu.  Select the percentage change
  15. in volume of the sample between the pointers then select OK (ie 200% doubles
  16. the sample volume, 50% halves etc).  Selecting the MAX button will work out
  17. the maximum it can increase the volume by without distorting the sample and
  18. set this to be the default.  Note: It is possible to increase the volume more
  19. than the maximum, this will clip or distort the sample. (This can be very
  20. useful). Now works on 386's, PS/2's and DRDOS that it used to crash under!
  21.  
  22. ------------------------------------------------------------------------------
  23. PUBLIC DOMAIN - FREEWARE
  24.  
  25.      This document provides brief instructions into the use of the PLAY
  26.      sound sample replaying software. This is therefore not a demo version
  27.      and is not disabled in any way.
  28.  
  29.      Please distribute play to as many people as possible (see legal
  30.      notice at end of file)
  31.  
  32. ------------------------------------------------------------------------------
  33. WHAT DOES IT DO?
  34.  
  35.      PLAY allows you to play and edit sound samples from a variety of machines,
  36.      AMIGA,ATARI ST and MAC samples have been played with great sucess through 
  37.      the internal speaker.  It has a few 'fancy' features as well!
  38.  
  39. ------------------------------------------------------------------------------
  40. WHAT DO I NEED?
  41.  
  42.      To simply play a sample from start to finish, Nothing more than the
  43.      play.com file and the sound sample file
  44.      ....any machine should do as long as it has a decent sized speaker and
  45.      MSDOS 3.00 or above (an 80286+ would be preferable)
  46.  
  47.      If you have VGA graphics and a MOUSE installed the fun starts, allowing you
  48.      to look at the waveform and play bits of it - alter frequencies and do all
  49.      sorts of wierd and wonderful things.
  50.  
  51. ------------------------------------------------------------------------------
  52. HOW DO I RUN IT?
  53.  
  54.      If you have VGA and a MOUSE driver installed just type
  55.  
  56. C:\> PLAY
  57.  
  58.      Otherwise type
  59.  
  60. C:\> PLAY /?
  61.  
  62.      to get a list of the things you can do from the command line.
  63.  
  64. ------------------------------------------------------------------------------
  65. HARDWARE DETAILS
  66.  
  67.      By addition of a piece of hardware costing around 20 quid (to build) onto a
  68.      spare printer port you can sample your own sounds and replay them through
  69.      your hi-fi with really astonishing quality.  The replay only section
  70.      can be built for only 5 pounds, and details of the circuit can be found
  71.      in the documentation for MODPLAY, an Amiga Sound/Noisetracker player.
  72.  
  73. ------------------------------------------------------------------------------
  74. CIRCUIT DIAGRAM
  75.  
  76.      For a modest gift, I will send two 3.5" (Branded) High Density disks with
  77.      the current version of PLAY and RESPLAY together with nicely printed
  78.      instructions and a copy of the circuit diagram.  To obtain this
  79.      package, send 10 pounds (UK) to the address at the end
  80.      of this document (cheque/postal order or mail me first) - this
  81.      also applys to international users (if you have problems with currency
  82.      please let me know).  
  83.  
  84. -----------------------------------------------------------------------------
  85. LENGTH OF SAMPLE
  86.  
  87.      It depends on what frequency the sample is and how much memory is free -
  88.      at 16kHz (the speed I like to sample at) I get about 33 seconds into
  89.      memory with no TSRs except a Disk Cache - I have a mac sample at 11kHz
  90.      of the entire Dr. Who. theme tune;  Sorry, until I fathom how
  91.      to use Extended/Expanded memory it can't use it! (Well, I've now worked
  92.      out how to use it, just I can't get it to work!)
  93.  
  94. ______________________________________________________________________________
  95. AMIGA/IFF
  96.  
  97.      The PLAY program now supports AMIGA .IFF files - during loading it
  98.      looks for a IFF header and if found obtains all the information on
  99.      the speed and format of the sample.  The interactive version strips
  100.      the header and converts the sample before displaying it.  The write
  101.      command allows an Amiga .IFF file to be written (it stores the 
  102.      speed and alters the format for you automatically).  So, you can
  103.      load standard samples - set the speed to the one that sounds most
  104.      natural and write as an IFF file that can then be simply played
  105.      by typing 'play s name'.
  106. ____________________________________________________________________________
  107.  
  108.  
  109.             INSTRUCTIONS FOR USE
  110.             ====================
  111.  
  112.  
  113. PLAY FROM THE COMMAND LINE!
  114. ---------------------------
  115.  
  116.      Usage: PLAY [-k<nn>] [-options] [<filename>]
  117.  
  118.        -k<nn> = Select Play/Record speed in kHz (default 16kHz)
  119.                 (in range 05...39)
  120.  
  121.      Options: (more are displayed if you do PLAY/?)
  122.  
  123.        -s     = Play sample named through PCs speaker (Lo-Fi)
  124.  
  125.      Example:
  126.  
  127. play -smarvin.smp          - Plays the file test.smp at 16kHz
  128. play -k05 -sa:marvin.smp   - Plays the file test.smp at 5kHz from A:
  129.                              (note leading zero required)
  130.  
  131.      When sample has loaded it will automatically start playing and
  132.      can be stopped by pressing any key (and I mean ANY key!!)
  133.  
  134.      There are a few other options such as recording from the command
  135.      line and setting which port the hardware is connected to and
  136.      doing echo's and things - but you need not worry too much about
  137.      them until Version 4.00!
  138.  
  139. INTERACTIVE PLAY!
  140. -----------------
  141.  
  142.      Usage: PLAY (or PLAY /I)
  143.  
  144.      (Useful hint: PLAY /k11/I will take you into interactive mode
  145.       with the frequency set to 11kHz etc... lets you create a batch
  146.       file that loads PLAY with some default values - you can also
  147.       do things like PLAY /k11 /l1 /i to set the port default as well)
  148.  
  149.      If VGA board is installed then programme will show initial
  150.      screen. Although all commands can be acessed from the
  151.      keyboard, I'm afraid you will need a mouse + driver
  152.      installed due to a wierd bug I'm working on! (You can
  153.      operate it entirely from the keyboard you see)
  154.  
  155.      The screen is divided into 3 areas, the top line contains some
  156.      buttons giving information on the program.  Left Click on any
  157.      button to do that command, Right Click to get help on that
  158.      command
  159.  
  160.      The next bit is a graph of the current sample.
  161.  
  162.      The bottom section contains more buttons with lots of
  163.      features!
  164.  
  165.      The (blue) pointers can be moved by picking them up with the mouse,
  166.      or by using the control 'hot-spots' either side of the little
  167.      number indicators.  The numbers give the time in Seconds at which
  168.      the pointer is pointing.
  169.  
  170.      The middle number and surrounding 'hot-spots' is the frequency in
  171.      kHz and this can be altered in 0.25 kHz steps or you can jump to
  172.      11kHz,16kHz or 22kHz directly.
  173.  
  174.      The various commands are not explained here, help can be got
  175.      by holding down the right mouse key when you are over a
  176.      button.
  177.  
  178. Note: CUT/COPY/PASTE rely on a temporary file c:\play.cut, if you
  179.       don't have a hard drive you cant use these commands (sorry,
  180.       but it's too slow off a floppy - I'll let you change the
  181.       default in a later version so you can make it store on a
  182.       high-memory Ram Drive or something)
  183.  
  184. FAVOURITE BBS
  185. -------------
  186.  
  187.      Try 'Kingdom of GREYHAWK' on Derby (0332) 756414 24hr for the latest
  188.      versions and lots and lots of samples - Don't forget to
  189.      mention PLAY when registering! (300...14400 baud) [+44-332-756414]
  190.      (note that this is the first source for PLAY, secondary sources
  191.      are updated within a week or so - also this board sometimes keeps
  192.      test/pre-release versions.
  193.  
  194. MAIL ME?
  195. --------
  196.  
  197.      Please mail me about any bugs or future enchancements you
  198.      would like to see.  Leave a message on Greyhawk BBS
  199.      (2:250/404.5 if you use NetMail)
  200.      
  201.      From a University/Poly or other site, mail 
  202.      "mjhc8@uk.ac.bradford.eleceng" with any comments etc. and I can
  203.      add you to the mailing list for release information. (if this
  204.      address does not work or it is after 1992 try
  205.      "mark.cox@f404.n250.z2.fidonet.org"
  206.  
  207.      Normal Post does OK too, only a little slower! :-)
  208.  
  209. BUGS
  210. ----
  211.      If you find any more please let me know!
  212.  
  213. _____________________________________________________________________________
  214.  
  215. Copyright/License/Warranty
  216. --------------------------
  217.  
  218. This document and the program file PLAY.COM ("the software") are
  219. copyrighted by the author.  The copyright owner hereby licenses
  220. you to: use the software; make as many copies of the program
  221. and documentation as you wish; give such copies to anyone; and
  222. distribute the software and documentation via electronic means.
  223. There is no charge for any of the above.
  224.  
  225. You are specifically prohibited from charging, or requesting
  226. donations, for any such copies, however made; and from
  227. distributing the software and/or documentation with commercial
  228. products without prior permission.
  229.  
  230. NO FOR-PROFIT ORGANIZATION IS AUTHORIZED TO CHARGE ANY AMOUNT
  231. FOR DISTRIBUTION OF COPIES OF THE SOFTWARE OR DOCUMENTATION,
  232. OR TO INCLUDE COPIES OF THE SOFTWARE OR DOCUMENTATION WITH SALES
  233. OF THEIR OWN PRODUCTS.
  234.  
  235. THIS INCLUDES A SPECIFIC PROHIBITION AGAINST FOR-PROFIT
  236. ORGANIZATIONS DISTRIBUTING THE SOFTWARE, EITHER ALONE OR WITH
  237. OTHER SOFTWARE, AND CHARGING A "HANDLING" OR "MATERIALS" FEE OR
  238. ANY OTHER SUCH FEE FOR THE DISTRIBUTION.  NO FOR-PROFIT
  239. ORGANIZATION IS AUTHORIZED TO INCLUDE THE SOFTWARE ON ANY MEDIA
  240. FOR WHICH MONEY IS CHARGED WITHOUT PRIOR PERMISSION FROM THE
  241. COPYRIGHT OWNER.
  242.  
  243. No copy of the software may be distributed or given away without
  244. this document; and this notice must not be removed.
  245.  
  246. There is no warranty of any kind, and the copyright owner is not
  247. liable for damages of any kind.  By using this free software,
  248. you agree to this.
  249.  
  250. The software and documentation are:
  251.  
  252.                    Copyright (C) 1990/1991
  253.  
  254.                    Mark J Cox
  255.                    29 Lundie Close
  256.                    Stenson Fields
  257.                    Derby
  258.                    DE2 3AN
  259.  
  260. All trademarks/registered names acknowledged.
  261.